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Description 

Technical Field of the Invention 

5 The invention relates to data processing systems and to a method of providing help to a user of such a 

system. 

Background of the Invention 

10 It is common practice for programmed data processing systems to provide help to an operator or user in 

response to a request for help. Such help is displayed to the operator at a workstation and frequently replaces 
the previous display screen entirely. Help may consist of actual help information or of a menu or index of pos- 
sible help from which the operator is required to select an item. Such indices can be very extensive and labor- 
ious to search in themselves. 

is So called contextual help is known in which the help provided is not merely general to the current screen 

or application but is specif Ic to the actual position of a cursor or pointer on the screen. Three related articles 
describing a contextual help system by RE Berry. S E Johnson et a!, are found in the IBM Technical Disclosure 
Bulletin (Vol 27, No. 10B. March 1985 at pages 6126, 6127 and 6128). These articles show the provision of 
contextual help in windows on a display screen. Two types of Help panel are possible, Active and Passive. 

20 The Active panel allows the operator to make further unspecified selections from within the panel. However, 
no other provision for knowing what alternative help is available is made. 

Another contextual help system making use of windowing capabilities is described in European patent ap- 
plication 0185845 A2, entitled "Help placement on a screen for a computer user". Help messages are displayed 
in a window which is so positioned in areas of the screen as to minimise the overlapping or obscuring of the 

25 screen content. 

Also known in the provision of help to a computer user is the concept of multi-level help in which, if the 
initially displayed information (first level help) is inadequate, the user may request turther more detailed Infor- 
mation (second level help). Examples of systems employing multiple levels of help can be found in an article 
by P D Koeller et al in the IBM Technical Disclosure Bulletin entitled "Improved method for Help Lookups" (Vol 
30 29, No.1. June 1986, P 291) and in European published patent application 0190419 A2 entitled "Method for 
providing an on-line help facility for interactive information handling systems". 

EP-A-0273248 further discloses the provision of multiple windows on the screen, where the user is prompt- 
ed by one window to select other windows. 

35 Disclosure of the Invention 

The above mentioned prior art thus fails to provide easy location of alternative or related help at the same 
level as the contextual help initially provided. 

Accordingly, the present invention provides a data processing system as set forth in claim 1. 
40 The invention also provides a method of providing help to a user of a data processing system as set forth 

in claim 15. 

By providing a help map concurrently with the help text and application, the user is enabled, without losing 
track of the circumstances in which he first requested help, to consider and select alternative related help text 
at the same level which may be more appropriate to his needs. This does not exclude the known provision of 
45 help at different levels, in addition, such as, for example, a lower tutorial level of help. 

Although selection could be made purely on the basis of a typed response to messages, it is preferable 
that the selection means is associated with the visible indicator so that the displayed item indicated by the in- 
dicator is selectable by operation of the selection means. This could Involve selection of an item indicated by 
a cursor by operation of an entry key as a keyboard or could be effected with a light pen. However, the preferred 
so implementation is a so called "mouse" device in which movement of a pointer on the display is caused by move- 
ment of the mouse. Depression of a selection button on the mouse selects the item indicated by the pointer. 

In order for the contextual help means to access the help text store, it is preferred that the current state 
of the system be defined by a plurality of system state variables which the help means uses as addressing 
information. It is also preferred, that the system variables are ranked in an order corresponding to different 
55 orders of help text in the help text store. Thus, a system state defined by system variables including low order 
variables would result in a correspondingly low order (i.e more specific) help text whereas a system state de- 
fined only by high order variables would result in a correspondingly high order (i.e more general) help text. 
It should be noted, at this point, that the reference to help text of different order relates to the generality 
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or specificity of the text and not to the provision of different help function at different levels of operation. 
Although, in theory, the system variables could be used directly to address a help text store, it is preferred 

that the help text store is addressed by a key which is obtained from a key table to which the system variables 

are applied. The key can thus be an address actually used by the system memory whereas the system variables 
5 are essentially user or system function oriented. It will be realised that each system state, as defined by the 

system variables, does not necessarily correspond to a unique unit of help text. Some system states may share 

common help text so that addressing the key table will produce the same key. 

Another preferred feature of the invention, related to the provision of contextual help, is that the low order 

system variables relate to the position of the indicator on the screen. Thus the corresponding low order help 
10 text can relate directly to the item or area identified by the indicator. 

Aconvenient preferred version of this is that at least three orders of system variable are used corresponding 

to the application being executed, the current panel on the display screen which is owned by the application 

and any predefined box located within the panel. There are three corresponding orders of help text in the help 

store from high to low respectively. 
is It is also possible in some systems to have a fourth higher order of help corresponding to a system facility 

which owns the application. 

Turning now to the help map itself, although it is possible for a static map to be stored by the system, there 

are advantages in generating the map dynamically from the help text store. One of these advantages is that 

users can add to or modify the stored help text which will immediately be reflected in the map next time it is 
20 created. 

Clearly either a static or dynamic map may be too large to be viewed through the available window. It has 
been found preferable, where possible within the hierarchy, to select for display the map entries of the same 
order as the current system variables which share common higher order system variables and also to display 
the higher order entry represented by the common higher order variables. 

25 If by any chance, the map entry corresponding the current system variables is not visible immediately with- 

in the help map window, the window can be scrolled or panned conventionally to reveal the remaining entries 
sharing the same higher order entry until the required entry is found. 

Although scrolling and panning could be employed to reveal other areas of the map, it is preferable to pro- 
vide a more systematic selectively operable branching mechanism for the user to move around the map. This 

30 operates so that branching may be selected on given map entries to cause display of a new help map. Where 
the given entry was originally one of the lower order entries, it becomes the higher order entry on the new 
map. Where the given entry was originally the higher order entry, it becomes one of the lower order entries 
on the new map. 

To assist branching, the map entries preferably include icons, for example arrows, to indicate the permitted 
35 direction of branching. Where no further branching is possible from an entry, no icon is provided. The branching 
operation can be selected by any of the various selection techniques discussed above, the easiest being use 
of mouse and pointer. 

Although the map offers a convenient method of navigation around the help text, it need not be the only 
method by which alternative text may be obtained. In a preferred version of the system, a unit of help text can 
40 include selectable branch words withing the body of the text which are associated with related units of help 
text Branching to the related units of text occurs in response to selection of a selectable word by the indica- 
tor/selection means combination. The result of the branching operation is that the display manager replaces 
the original text in the help text window with the related text. 

As a further variant on the above, a glossary store may also be provided so that, upon selection of a word 
45 of help text from which no branch is permitted, a definition of the selected word or alphabetically nearest word 
in the glossary store is displayed in a separate glossary window. 

The invention will now be described in more detail, by way of example only, with reference to a preferred 
embodiment thereof as illustrated in the accompanying drawings. 

so Brief Description of the Drawings 

Figure 1 is a block diagram of the major hardware components of a data processing system according to 
the invention; 

Figure 2 illustrates schematically the help available in the preferred embodiment of a data processing sys- 
55 tern according to the invention; 

Figure 3 illustrates the format of a Master window produced on the display in the preferred embodiment 
of a data processing system according to the invention; 

Figure 4 illustrates a display screen layout produced in the preferred embodiment at the point of selection 
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of a View/Change application; 

Figure 5 shows a display screen resulting from the running of the View/Change application of Figure 4; 
Figures 6-8 shows successive display screens which are produced in the preferred embodiment as a result 
of employing certain of the help provision illustrated in Figure 2; 

Figure 9 shows portions of a Help Index Table and Help Text Store employed in the preferred embodiment 
of the invention; and 

Figure 10 illustrates schematically the creation of Help Map in the preferred embodiment of the invention. 
Best Mode for Carrying out the Invention 

A data processing system according to the invention comprises both hardware and software. The hardware 
of the system is illustrated in Figure 1 and is conventional. 

A microprocessor 10 communicates with a fixed memory 11 and with peripheral devices. These included 
fixed disk storage 12 and floppy disk storage 13 by way of which programs can be loaded to cause the system 
f5 to execute data processing tasks. The results of there data processing tasks are displayed to an operator or 
user, by way of a graphics adapter 14, on a colour display 15. 

Input to the system by the operator may be from keyboard 16 which has a normal range of keys, including 
an entry key 17 which may be used to indicate selection, and a help key 18 (labelled F1) for requesting help 
from the system. As an alternative to requesting selection and help from the keyboard, a mouse device 19 is 
20 also provided. Movement of the mouse causes movement of a pointer on the screen of display 1 5. The mouse 
is provided with at least two distinct buttons, one of which, 20, indicates selection of the item at which the pointer 
Is pointing and the other of which. 21 . is a request for help, whose function is exactly equivalent to operation 
of the F1 key on the keyboard. 

The software part of the data processing system consists of normal operating software for controlling op- 
25 eration of the hardware and an application program which the user desires to run. 

One example of suitable hardware and operating system would be an IBM PS/2 computer (models 50, 60 
or 80) with an IBM OS/2 (Release 1.0) operating system (IBM is a Registered Trademark and PS/2 and OS/2 
are Trademarks of International Business Machines Corporation). 

The application program which is part of the data processing system of Figures 1 and 2 is of the multi- 
30 tasking kind in which numerous tasks can run simultaneously. It consists of general system functions and a 
set of basic applications that enable general data manipulation and presentation to be performed. 

The system functions include two primary components, the Display Manager and the Data Store Manager. 
The latter manages all data used by the system which is held in Data Stores. A Data Store is single level and 
contains various data values and attributes as Data Items. A data dictionary provides information about the 
35 individual Data Items which are referenced by symbolic names. 

The Display Manager provides full display services in all points addressable mode. It is fully integrated 

with the Data Store. . 4 _ 

The display manager allows many logical screens (panels) to be presented on the physical display 15. 
These panels are presented through windows which may be a different size from the related panel. The win- 

40 dows may be displayed with or without overlap. With the exception of data entry, any of these windows may 
be directly employed even if they are partly hidden by another window. Data entry may only be performed on 
the top most window, which is identified by the presence of a data entry cursor. The Display manager presents 
data from the DataStore; the application does not write data to windows. All applications present their infor- 
mation within these windows using panels. The panel is the application's defined display layout which will be 

45 presented somewhere on the physical display through a window. 

The entire screen is available to display windows which are optimally placed by the display manager. All 
windows have borders and may overlay one another if necessary. The user may move a window, even partially 
off the screen. Error and warning messages plus help information appear through Pop-up windows. 

The physical screen is referred to as the 'desk top' and always contains a Master window giving access 

so to all system function. The Master window occupies minimal screen space, containing a Prompt Area. Com- 
mand Une and an Application Action Bar (AAB). consisting of a number of choices. Its format is as shown if 

^The Application Action Bar choices may be selected using keyboard 16 or mouse 19. On selection they 
present Pull-down windows with the following services:- 
55 Process: Initiation of saved specifications, programs and procedures; 

Facilities: Initiation of any enrolled application; 

Dat a: Data Dictionary Management function are provided via a data window; 

Actions- Enable the user to perform various actions, set profile information and enroll new facilities 
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and applications; 
Desk Top: Manipulation of objects on the desk top; 

Exit* Close down the system and any active applications: 

By way of example, and as illustrated in Figure 4 the facilities service is accessed via the Facilities AAB 
5 choice on the Master Window. Facilities include, among others, General, Reporting, Statistics and Develop- 
ment as shown in the pull-down window 30 in Figure 4 which appears on the desk top when selected by means 
of the mouse 17 and pointer. 

Access to individual applications within these facilities is achieved by selection of the relevant facility. This 
gives a Pop-up window containing a selectable list of applications. In the example of Figure 4 the General Fa- 
10 cility is selected and a pop-up window 31 lists the available applications. The pointer 32 is pointed at an ap- 
plication called View/Change which will be used to illustrate the help facilities of the system. Noteworthy in 
Figures 3 and 4 is any area 34, in the AAB designated "F1=Help". This is an alternative way of requesting help 
and requires the use of the pointer to point at area 34 and the operation of the select button on mouse 19. 
Common Action Areas (CAA's) at the bottom of windows 30 and 31 enable the cancellation of the current 
15 panel. CAAs. In some cases, may also contain an "F1 =Help" box. 

As well as the Master window on the Desk Top. every application has a Main window with an Application 
Action Bar. An example in Figure 5. shows a screen with the selected View-Change application in progress. 
In any application, Pull-down windows are presented below the AAB choice on selection. Secondary windows 
may be presented by the application for displaying information supplementary to that in the Main window. Pop- 
up windows may also be used to present very short term dialogues adjacent to a box on a Main or Secondary 

WI "to assist with the description of the helpfunction, a more precise definition of the terms "Window-, "Panel" 
and "Box" is desirable. 

Panels are virtual rectangular areas used to present information through the windows. Each panel consists 
of a rectangular area with a background colour, and optional foreground colour and pattern, and a set of boxes. 
Each panel is named. 

Boxes are used to present character data or graphic objects within the panel. Each box is also rectangular 
and is named. 

A window Is a rectangular area through which panels are displayed, the window is placed suitably by the 
30 Display manager unless the application specifies that the window be placed adjacent to a box in another win- 
dow. During a session, users may reposition the windows if desired. 

Each window is known by name to the application and the window size limit is essentially that of the panel 
it is displaying. A window has an initial size given by the associated panel but this may be changed by the ap- 
plication or 'Desk_Top' function. Windows are positioned suitably on the desk top by the system. However, the 
35 user may reposition a window. The cursor indicates the active window (for data entry purposes). Additionally, 
all windows have borders which clearly define the extent of the window. The top border contains a title. The 
border may also contain arrows that can be selected for scrolling. 

Turning now to Figure 2, a system for providing a total support environment for the user is illustrated. All 
the information necessary to use the system is available online, with a few exceptions. Help is available at 
40 three different levels and can be requested at any time during a session. 

First level support is provided when the Help key 18 or 21 (F1) is pressed once. Amessage 22 is displayed 
within a pop-up window and relates to the area under the pointer. The help provided is associated with either 
the box or panel at which the pointer is directed. This first level of support provides an instant clue for the user 
who is momentarily puzzled, or who requires very little information to get on the right track, but will probably 
45 be of little support to users who lack an understanding of the application they are using. First level help is pro- 
vided by the application concerned. 

Second level support is provided by the Invocation of a special Help program when the user presses the 
Help key (F1) twice with the pointer in the same area, or by selecting an F1=Help box in an AAB in, for example, 
an application window 23. Second level help takes the form of a longer piece of text displayed within a Help 
so window 24 

The information displayed is dependent upon which application the user is in, and at what point within that 
application. Support is contextual. Selecting the F1=Help box displays overview information about the appli- 
cation or facility which owns the box. 

The Help window 24 provides the additional options of selecting access to a Glossary 25 for explanations 
55 of words or phrases, access to a hierarchical map 26 of the second level help text, and access to a third level 
of support, the tutorial 27. 

Second level support is extremely flexible. The user who understands the concepts and purpose of an 
application, and who invokes support for clarification of a specific point, is likely to get exactly the information 
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he needs. The user requiring more detailed or general information than that provided can use the map browsing 
facilities to move up or down a hierarchical level of information. The user who is out of his depth can access 
the tutorial level of support to discover the concepts behind application, and get an overview of its function 
and the tasks it supports. Selection of third level support is by selection of a Tutorial" box in the help window 
24 

Third level support is intended for first-time users of either the system or a particular application. A tutorial 
is explanatory in intent. It covers principles, facilities and typical tasks. It does not cover every possible task. 
It may involve a two-way Information flow; the user may be asked to answer question or do exercises. 

The four components provided by the main Help program are Text 24, Help Map 26, Glossary 25 and Tu- 
torial 27. The first three can be concurrently displayed on the same screen whereas a Tutorial can only be con- 
current with the Glossary. , ... . 

The Help Text is provided in a main window 24 with AAB which is scrollable. It is invoked through initial 
support selection or via the Help Map 26. THe Help Text function also allows branching by selection of a se- 
lectable word to alternative Text. If there is no alternative Text, the program branches to the nearest Glossary 
is entry. 

The Help Map is controlled by a sub-program invoked through Help Map selection on the Help Text window 
AAB. It provides a window based graphical tree structure 28 showing related Help Text titles and selection of 
the related Text items 29, which appear in the window 26. The Help Map program allows scrolled movement 
through the tree and branching up and down the tree structure. 

The Glossary is also controlled by a sub-program invoked through Glossary selection on the Help Text 
window or the Tutorial. It provides definitions given by selecting a keyword from the Help Text or Tutorial or by 
typing in the desired word. If there is no entry for the desired word, the alphabetically nearest words in the 
Glossary are displayed. m 

Tutorials are also controlled by a sub-program invoked from the Help Text window. Tutorial text is provided 
25 in a main window 27 with AAB which is scrollable. As with Help Text, Tutorials allow branching by selection to 
alternative Text and branching by selection to a Glossary entry. They also replay recordings for demonstra- 
te structure and operation of the Help and Help Map programs will now be explained in more detail with 
particular reference to the screen examples shown in Figures 4-8. It will be assumed that as a result of the 
selection of the View/Change application from the window 31 of Figure 4, the user has retrieved the table of 
data of employee salary details shown in Figure 5, which is displayed in the application window 50, beneath 
master window 51. It is assumed the the user wishes to change the column headed -Salary" to read "Com- 
pensation" but does not know the procedure for doing so. 

Although the experienced user would point the pointer 52 at the word "Salary" and, by pressing the F1 
key twice, get the required contextual help on column headings, shown in Figure 8, the less experienced user 
might well press F1 help with the pointer on the window border or in a blank area. Pressing F1 once, displays 
a Help message window containing the message "Select a View or Data Items to display the selected data". 
As this dearly does not provide the right sort of help, the user presses F1 again. This causes the view/Change 
application to set the system variables defining the current state of the application and to call the Help program. 
The system variables define the Facility, Application, Panel and Box. In the example, the first three are set to 
•General", "View/Change" and "View/Change" and null values are entered in the box. The name of the first 
panel in an application is always the same as that of the application, l.e "View/Change", though the system 
variable is a panel variable. 

The Help program opens various panels of its own, including the main Help window corresponding to 24 
45 (Fig 2) and interrogates the system variables to determine the subject on which help is required. A title for the 
Help window is created. A Help Index table 90 is then interrogated, as illustrated in Figure 9, to extract a key 
value 91 corresponding to the system variables. This key is used to interrogate a Help Text table 92 to extract 
corresponding Help Text 93 for display in the Help Window. 

In the example, the text displayed Is shown in Help window 60 in Figure 6. This provides panel level help 
so for the View/Change panel (which may be different from application level help). This still does not give the 
required information but is getting close to the subject of interest 

The user may then access the Help Map to find out what other help is available in this area. This is done 
by pointing the pointer at the word "Reference" in the AAB of window 60 which produces a small pull-down 
window 61 listing the two reference functions Help Map and Glossary. Pointing the pointer at the Help Map 
55 entry and selecting it causes the display of a Help Map similar to that shown at 70 in Figure 7. 

Selection of Help Map causes a Help Map program to generate the help map by creating current lists of 
all Facilities Application, Panels and Boxes. These are arranged in a tree structure as shown schematically 
in Figure 10* in which higher order (or parent) entry has associated with it a number of lower order (or child) 
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entries. The parent entry corresponding to the current system variables is determined and placed In the Help 
Map panel along with all child entries which share that parent The lowest specified (i.e non-null) system va- 
riable is one of the child entries. Dynamic creation of the Help Map, as opposed to storing it statically, permits 
modifications and additions to the map to be made. 

5 It may not always be possible to display all child entries in the Help Map window 70 and this is the case 

in the example chosen, the Help Map program initially displays the first five child entries in alphabetic order. 
Where the View/Change application entry 71 is the parent, the View/Change panel entry 72 is not one of the 
five initially displayed child entries. The Help Map window may however be scrolled downwardly as illustrated 
by arrows 73 in its border to bring the View/Change panel entry 72 into view as shown in Figure 7. 

10 The various entries are enclosed in boxes which include sub-boxes at their left hand margins. The presence 

of an arrow in the sub-box indicates that there are further portions of the help map including the particular entry. 
An upward arrow such as 74 indicates that a higher level of map structure is available in which the View/Change 
application entry is a child entry. A downward arrow such as 75 Indicates a lower level of map structure Is 
available In which the child entry, such as View/Change panel is the parent entry. 

15 Selection of an alternative portions of the Help Map is by pointing at the branching arrow and selecting. 

In the present, example the pointer 76 is used to select a downward branch from the View/Change panel entry. 

The Help Map program then displays the lower level Help Map portion shown in window 80 of Figure 8. 
At this point the displayed help text in window is unchanged from that in window 60 in Figures 6 and 7. 

The new help map in window 80 contains the View/Change panel entry 81 as parent, though this time with 

20 an upward branch arrow. The child entries relate to boxes within the View/Change panel and include an entry 
82 entitled "Column Heading". Selection of entry 82 by pointer 83 causes the system variables to be reset to 
reflect those for the "Column Heading" box and the replacement of the Help Text In window 84 by new text 
relating to Column headings. The user now has enough information presented in the Help Text main window 
to enable him to make the change to the column heading"Salary" in the main application window 85. 

25 It will be noted that the application window does not disappear when the Help Text and Help Map windows 

are opened, so that the user is unlikely to forget the problem which caused him to request help and can initiate 
the action directly. 

It may also have been noted that there is an "F1 =Help° area in the Help Text windows, 60 and 84, them- 
selves. This is selectable by means of the pointer to produce help relating to the use of the Help function rather 
30 than on the subject of the text. 

Help at levels above box level (i.e panel level) may be selected by pointing and selecting blank areas and 
borders of the application window or the "F1=Help" area of its AAB. Help at the Application or Facility level 
must be selected from the appropriate display such as Figure 3 or 4 or by branching up the map. The highest 
level of help is system level help obtained by branching upwards from Facility level help or by selecting con- 
35 textual help on the overall application program name. 

One further aspect of the help architecture of Figure 2 is the use of branching from displayed Help Text 
words in the Help Text may be made selectable when it is created. Selection of such a work with the pointer 
causes the key to the current help text to be applied with the selected word to a Help Text Branch table. For 
each selectable word, the Help Text Branch table.contains a Destination Key which is the key to Corresponding 
40 Help Text In the Help Text Table. The Help Text corresponding to the selected word replaces the original Help 
Text in the displayed window. Thus If the words "Column" or "Heading" had been predefined as selectable 
words in the View/Change help text of Figure 7, selection of these words with the pointer would have produced 
the Column Heading help text without the need to use the Help Map. 

As previously explained, if a word is not predefined as selectable, an attempt to select it results in a Glos- 
45 sary program being called which displays in yet another window, the selected word and its definition or the 
alphabetically nearest words. 

Having described the principles of operation of preferred embodiment, illustrated by example, there follows 
a detailed description of the Help and Help Map programs. 
Program Name: HELP 

so The Program consists of a number of "On Blocks" of code and Procedures as defined be- 

low. 

Function: An application for providing in context help for a general application program. This is the 

master controlling task. This application is a basic system component. This task runs for 
the whole of a PAS session, and provides for the display of second level help text, as well 
55 as controlling the other tasks. This task runs continuously so that a reasonable response 

time can be acheived for the display of help text. The application also has tasks which 
provide tutorials, glossary definitions and a help map. These are all started from this task 
when required. Separate tasks are also used for output of information to OS/2 files or prin- 
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Invocation: 



10 



Panels opened: 



15 ON Blocks: 



20 



25 



30 



35 



40 



45 



Procedures: 
DETSUBJECT 
EXITSELECT 
FINDKEYS 
GETTEXT 
GETWORD 
MAKETITLE 
BRANCH 
REFSELECT 
ACTSSELECT 
QUEUESUPPORT 
SET POINTERS 
TEXTSELECT 
TUTSELECT 
Tasks started: 
I.HelpMap 
I.HelpGlos 
I.HelpPr 
I.HelpTut 
General.ShowErr 



ters. 

Help Is started by the general application Control when the system is started up. There- 
after, any task may run to its QUEUE block, to request the display of second level help 
on a certain subject. This normaliy takes place when a task receives a HELP event signal, 
following the user pressing F1-F1 whilst the pointer is over one of the tasks windows. First 
level help is provided automatically by the system, for the first press of F1. The subject 
for which help Is required is specified by settting the variables 'S.Help.Faci li- 
t/, 'S.Help.Appllcation\ 'S.Help.Panel' and 'S.Help.Box* prior to running to the QUEUE 
block of this task. These variables will have default values loaded into them by the system 
following an F1-F1, and often do not need to be explicitly set by the calling task. 
HelpMain 
HelpAABRef 
HelpAABAct 
HelpAABExt 
BREAK 
DESKTOP 
ERROR 
HELP 
QUEUE 
QUIT 
SCROLL 
SELECT 
START 
STOP 

Determine help subject. 
'Exit* pull-down handler. 
Find keys for text and tutl. 
Get text for specified key. 
Extract word from string. 
Set up title boxes. 
Branch to new piece of text 
'Reference' popdown handler. 
'Output' popdown handler. 
Queue 'Support* if possible. 
Set up pointers to help data. 
Handler for selects on text 
'Tutorial' button selects. 



50 



55 
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Input: 



I. Messages. Help 



Translatable strings used 
by the whole Help 
application, for prompts 
etc. 



10 



General . Messages . 
General 



Translatable strings for 
general use by all 
programs • 



15 



User input 



- From selections etc. 



20 



25 



30 



35 



40 



45 



SO 



S . Help . Facility , 
S . Help . Application , 
S. Help. Panel, 
S. Help. Box 



•.Helplndex.* 



*.HelpText.* 



*.HelpTxBra.* 



Define the subject for 
which help text is to 
be displayed. Set prior 
to running this tasks' 
QUEUE block. 

Help index tables, which 
occur in DataStores which 
contain help text or 
tutorials. Used to relate 
the help subject, as 
specified in the •S.Help.' 
variables, to a title, 
piece of help text and 
tutorial . 

Help text tables. Used 
to store the pieces of 
help text. 

Help text branch tables. 
Used to hold the data for 
branches between various 
pieces of help text. 



Output: A screen display of help text, which may optionally be output to an OS/2 file or printer. 
Process: The Help application consists of 7 modules which have the following fu notion s:- 
55 Help - This is the main application module. It runs continuously, and provides the main help text 

display function. It also controls the starting of the tutorial, help map and glossary modules. It 
uses a separate module to handle the printing of help text. It provides the variables through which 
all the modules communicate to one another. 
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HelpMap - This module is used as a sub-task by the Help module. It produces a help map. which 
shows the user all the help text available within the system. The help map is used in conjunction 
with the main help text display. 

HelpTut - This module is started as a master task by the Help module. It prodvides a tutorial for 
s the user, on the specified subject Once started the tutorial can be used independently of the 

rest of the help system. 

HelpGlos - This module is started as a master task by the Help module. It displays glossary def- 
initions for words, to the user. Once started the glossary can be used independently of the rest 
of the help system. 

10 HelpPr - This module is started by the Help module, as a master task. It is used to control the 

printing of help te 

HelpTuPr - This module is started by the HelpTut module, as a master task. It is used to control 
the printing of tutorial text 

HelpGIPr - This module is started by the HelpGlos module, as a master task. It is used to control 
is the printing of glossary definitions. 

Errors: No error should occur during normal running of this program. Any that do are unexpected, and 
are passed to the 'ShowErr' program as normal. 
The procedures are described below. 
Procedure name: DETSUBJECT 
20 Function: This procedure determines the subject for which Help is required by examining the ap- 

propriate variables for data passed from the queueing task. The variables TacNa- 
me\ 'AppName', 'PanName', and 'BoxName' are set to indicate the required Help sub- 
ject. 

Parameters: No 
25 Called by: ON QUEUE 

Calls: None 

The actions performed by this procedure are as follows:- 

Determine help subject 

Determine the facility, application, panel and box for which Help has been requested. All tasks which 
30 queue/run to the Help applications' ON QUEUE block pass this information in the appropriate 'S.Help.' vari- 
ables. Ensure that the subject defining variables never contain unknown values. 
Procedure name: EXITSELECT 

Function: This procedure is called whenever a selection is made on the 'Exit' popdown. 

Parameters: No 
35 Called by: ON SELECT 

Calls: None 

The actions performed by this procedure are as follows:- 

Exif puil-down handler. When 'Exit Help' is selected queue to the stop block, which quiesces the applica- 
tion. 

40 When 'Resume Help' is selected just remove the popdown. 
Procedure name: FIND KEYS 

Function: This procedure checks the current datastore to see if it has a Help index table. If it does 

it searches this for a reference to some Help on the specified subject If an appropriate 
entry is found in the Help index table the procedure returns the key to the Help Text 
45 in TextKey* and the Tutorial key in TutKe/. If either of the keys is not found it is set to 0. 

Parameters: Yes 

Called by: ON 

QUEUE 

Calls: None 

50 The actions performed by this procedure are as follows:- 

Find keys for text and tuft Clear the keys. If the datastore contains a help index table with a column for 
help text keys. Search for an entry for the required subject in the Help index table. If no entry was found for 
the required subject then no Help Text key is available. If an entry was found in the index then determine the 
key to the Help Text. If the key does not contain a valid value then clear it If the datastore contains a help index 

55 table with a column for tutorial keys. Search the Help index table for an entry for the specified subject If the 
subject was a box then ignore the box name and find the entry relating to the panel that the box is on. This is 
because boxes do not have their own tutorials, but use those for the panel that they exist on. If no entry was 
found for the required subject then no tutorial key is available. Get the Tutorial key. If the key does not contain 

10 
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a valid value then clear it. 
Procedure name: GETTEXT 

Function: This procedure checks that the current datastore contains a help text table, and if it does 

then it attempts to retrieve the help text specified by the key. If it is successful then this 
5 text is put into the vector Texf otherwise the vector is cleared. 

Parameters: Yes 

Called by: BRANCH 

ON QUEUE 

Calls: None 

10 The actions performed by this procedure are as follows:- 

Get text for specified key. 
Clear the vector for returning the text in. 

If the datastore does not have a help text table then no help text is available. 
If the specified key is invalid then no text can be found. 
is Search for the first tine of Help Text 

If it is not found then no Help Text is available. 

Retrieve the Help Text by loading lines from the Help Text table into the Text" vector until a line is encoun- 
tered which has a different key to the required Help Text. 
Procedure name: GETWORD 
20 Function: This procedure attempts to determine the word In the specified string that occurs at the 

specified character position within that string, tf a word is found it is returned in 'Word', 
otherwise a null string is returned. The procedure separates words using separators de- 
fined in the string 'I.Messages.Help_13_\ 
Parameters: Yes 
25 Called by: TEXTSELECT 
Calls: None 

The actions performed by this procedure are as follows:- 
Extract word from string. 

Check that the values passed in the parameters are valid. 
30 Define the separators. 

If the character at the specified position is a separator then no valid word can be found. 
Search for the start and end of the word, which contains the character at the specified position. 
Split the word out of the string. 
Procedure name: MAKETITLE 
35 Function: This procedure sets up the title for the Help Text based on the subject for which help was 

requested. 
Parameters: Yes 
Called by: BRANCH 

ON QUEUE 
40 Calls: None 

The actions performed by this procedure are as follows:- 
Set up title boxes. 

If there is no index table column containing titles, set the title to show the real facility, application, panel 
and box names. 

45 Determine the facility title from the Help index table entry for the facility. If non is found use the internal 

system facility name. If no facility was specified then use the internal name, which is null. 
Determine the application title In the same way as for the facility title. 
Determine the panel title in the same way as for the facility title. 
Determine the box title in the same way as for the facility title. 
so Procedure name: BRANCH 

Function: This procedure is called when it is required to branch to another piece of Help Text in the 

current datastore, specified by 'DKey'. The procedure checks that the piece of text exists 
and has an entry in the Help index table (to provide title etc), before it attempts to execute 
the branching operation. If the branch is successful then the flag 'BranchOIC is set, other- 
55 wise it is cleared. 

Parameters: Yes 
Called by: TEXTSELECT 
Calls: GETTEXT 



11 



EP0 380 491 B1 



MAKETITLE 

The actions performed by this procedures are as follows:- 
Branch to new piece of text 
Attempt to retrieve the new Help Text. 
5 Then try to find an entry for it in the Help index table (which provides its title, associated facility names 

etc). 

If both these tests pass then execute the branch: 

Set the new values into the subject defining variables from the index table entry for the new Help Text. 
Update the Help Text key. 

10 Attempt to retrieve the key to any related Tutorial from the appropriate Help index table entry. 

Hide or show the Tutorial' box, depending on whether one is available for the new subject or not 

Create the new title for the new text. 

Copy the new text to the screen display. 

Flag the branch as successful. 
is Otherwise, if either of the checks failed then flag the branch as unsuccessful. 

Procedure name: REFSELECT 

Function: This procedure is called whenever a selection is made on the 'Reference' popdown. 

Parameters: No 
Called by: ON SELECT 

20 Calls: None 

The actions performed by this procedure are as follows:- 

Reference' popdown handler. 

When 'Help Map' is selected; 

Set up the variables which are used to pass the Help Map subject to the Help Map sub task,.. 
25 ..and either start the subtask or, if it is already active, just queue to it 
When 'Glossary* is selected; 
If the 'Glossary' task is not already started,.. 
..set up the variables which are used to pass the Glossary subject to the Glossary task... 
Land start it 
30 Hide the popdown. 

Procedure name: ACTSSELECT 

Function: This procedure is called whenever a selection is made on the 'Output' popdown. 

Parameters: No 
Called by: ON SELECT 

35 Calls: None 

The actions performed by this procedure are as follows:- 

'Output popdown handler. 

Hide the popdown. 

Depending on which printing or filing option was selected set the mode for the print task accordingly. 
40 Set the subject defining variables to be passed to the print task. 

Start the Help Text print task. 
Procedure name: QUEUESUPPORT 

Function: This procedure is called from the 'ON QUEUE' block, at the beginning of the processing 

of a help request It checks to see if any of the support tasks are active, and if there are 
45 it queues to the appropriate one (providing that it is not a request from the task itself). 

This enables 'F1 ' keystroke requests to be routed to the support product when it is active, 
rather than producing help requests. If a support task is queued to then the flag 'Sup- 
portQd'is set, otherwise it is cleared. 
Parameters: No 
so Called by: ON QUEUE 

Calls: None 

The actions performed by this procedure are as follows:- 
Queue 'Support' if possible. 
Clear the success flag. 
55 |f the help request is from 'Support* itself, then don't queue back to it 

Determine the task handle of the most appropriate active support task (if any). 

If there is one queue to it. The subject is communicated to the support task via the 'S.Heip.' variables, which 
are already set prior to queueing/ running this application. 
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Procedure name: SETPOINTERS 

Function: This procedure is called from the 'ON QUEUE' block. It determines the name of the da- 

tastore in which Help for the required subject will be found, and sets up pointers to the 
columns in the help index and help text tables in the datastore. If any columns of the tables 
5 are unusable then the pointers to them are set to null strings. 

Parameters: No 
Called by: TEXTSELECT 
Calls: None 

The actions performed by this procedure are as follows:- 
10 Set up pointers to help data. 

Set all the pointers to nulls. 

If a datastore is found with the same name as the specified facility then use it, else quit here. 

If any of the help index table key columns is missing quit here. 

Set up pointers to the help Index table key columns. 
15 Set up a pointer to the help index table help text keys column, if one exists. 

Set up a pointer to the help index table tutorial keys column. If one exists. 

Set up a pointer to the help index table titles column, if one exists. 

If any of the help text table columns is missing quit here. 

Set up pointers to the help text table text key and lines of text columns. 
20 If any of the help text branch table columns Is missing quit here. 

Set up a pointer to the help text branch table destination key column. 
Procedure name: TEXTSELECT 

Function: This procedure is called whenever a selection is made in the area that displays the Help 

Text in the main window (i.e. a when a word of the Help Text is selected). 
25 Parameters: No 

Called by: ON SELECT 

Calls: GETWORD 

SETPOINTERS 
BRANCH 

30 The actions performed by this procedure are as follows:- 

Handler for selects on text. 
Determine which word, if any, was selected. 
If no valid word was selected do nothing. 

If a valid word has been selected from the Help Text then check if it has been set up to cause a branch, 
35 and if it has and the branch is possible then branch to the new piece of Help Text. 

Reset the pointers to the help tables in the datastore, in case either the tables or datastore have been al- 
tered. 

Check that a valid Help Text branch table exists in the datastore. 
Check that a branch has been set for the selected word in this piece of text. 
40 If it has then attempt to branch to the new Help Text. 

If the branch was sucessful then don't go on to provide a Glossary definition. 

If a valid word was selected from the Help Text but no branch took place, then attempt to find a glossary 
definition for the selected word. 

Set up the inter task communication variables,.. 
45 ..and either start the task or, if it is already active, just queue to it. 
Procedure name: TUTSELECT 

Function: This procedure is called whenever the Tutorial' button in the main window is selected. It 

sets up the variables which are used to pass the subject for the Tutorial and either starts 
or queues to the 'HelpTuf task. 
so Parameters: No 

Called by: ON SELECT 

Calls: None 

The actions performed by this procedure are as follows:- 
Tutorial' button selects. 
55 Set up the variables which are used to pass the Tutorial subject to the Tutorial task,.. 

..and either start the task or, if it is already active, just queue to it 
ON Name: BREAK 

Function: This block is executed whenever a BREAK occurs whilst this task is running. This can only occur 
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during the ON START block, and causes the system to be shut down, as Help is started during 
the initial system startup. BREAKs are not allowed anywhere else as there are no slow processes 
performed. 
Calls: None 
5 The actions performed by this block are as follows :- 

Create an outstanding BREAK event, which will be detected by Control. 
Then just stop. 
ON Name: DESKTOP 

Function: This block is executed whenever a desktop operation is performed in a window which is owned 
10 by this task. 

Calls: None 

The actions performed by this block are as follows:- 

Clear the prompt area. 

Remove any outstanding , ShowNote i messages. 
is If the desktop operation is a print or zoom then it can be ignored. 

Ignore any panels which are not provided by this program, specifically panels used for the AAB, CAAand 
prompt areas. 

If the panel that the operation acts upon is not already recorded as being changed then add ifs name to 
the vector of changed panel names. 
20 ON Name: ERROR 

Function: This block is called whenever an execution error occurs whilst this program is running. 

The 'ShowErr* program is started to provide some diagnostic information for debugging purpos- 
es, as is standard practice. No errors should occur during normal operation of this program, thus 
no attempt is made to trap or handle any. 
25 Calls: None 

The actions performed by this block are as follows > 
For debugging purposes. 
ON Name: HELP 

Function: This block is executed whenever second level help is requested in a window which is owned by 
30 this task. 

Calls: None 

The actions performed by this block are as follows:- 

Clear the prompt area. 

Remove any outstanding 'ShowNote' messages. 
35 When Help is requested run the task like any other application. 

ON Name: QUEUE 

Function: Programs requesting help queue to this block and set the variables S.Help. Facility, S.Help.Ap- 

plication, S.Help.Panel and S.Help. Box to define the level at which the Help is required and the 

exact subject. 
40 Calls: QUEUESUPPORT 

DETSUBJECT 

SETPOINTERS 

MAKETITLE 

FINDKEYS 
45 GETTEXT 

The actions performed by this block are as follows:- 

Queue to the Support product if active, and if successful do not provide any Help. 
Surface (and show if necessary) the main window. 
Clear the prompt area. 
so Remove any outstanding 'ShowNote' messages. 

Determine Help subject 

Determine the datastore that the Help Text will be found in, and set up pointers to the relevant help tables 

in it. 

Set up the title for the display. 
55 Search the index in the appropriate datastore for keys to the Help Text and an optional Tutorial for the spe- 

cified Help subject 

Show the Tutorial' box if a Tutorial is available. 
Attempt to get the Help Text. 
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Update the display with either the retrieved help text (if there is any) or a message to indicate that no help 
Is available. 

Reset the scrolling position. 
ON Name: QUIT 

Function: This block is executed whenever a QUIT operation is performed on one of the windows owned 

by this task. 
Calls: None 

The actions performed by this block are as follows :- 

Clear the prompt area. 

Remove any outstanding 'ShowNote' messages. 

When f Esc=Cance!' is selected on one of the popdowns, then hide the appropriate popdown. 
ON Name: SCROLL 

Function: This block is executed whenever the main help text window is scrolled. 
Calls: None 

The actions performed by this block are as follows:- 

Clear the prompt area. 

Remove any outstanding 'ShowNote' messages. 
Determine how many lines of Help Text there are. 
Find out how many can be displayed in the window. 
Scroll the appropriate amount in the requested direction. 
Limit the scrolling so that the limits of the text are not exceeded. 
Put out messages if either the start or end of the text has been reached. 
ON Name: SELECT 

Function: This block is executed whenever a SELECT takes place in one of the windows which is owned 

by this task. 
Calls: TEXTSELECT 
TUTSELECT 
EXITSELECT 
REFSELECT 
ACTSSELECT 
The actions performed by this block are as follows:- 
Clear the prompt area. 

Remove any outstanding 'ShowNote* messages. 

Depending on where the selection takes place, call the appropriate procedure to deal with that selection. 
Selection of a word in the main text area of the main window. 
Selection of the Tutorial 1 button in the main window. 
A selection on the 'Exit 1 popdown. 
A selection on the 'Reference* popdown. 
A selection on the 'Output* popdown. 
ON Name: START 

Function: This block is executed when the Help application is initialised. This is done once at system startup 

time, by Control. 
Calls: None 

The actions performed by this block are as follows :- 

Enable BREAKS. 

Handles for the other tasks within the application . (Set to null if task not active.) Variables used for passing 
data between the various tasks in the Help system. 

Pointers to columns in the help index, text and text branch tables. They are set by 'SETPO INTERS' every 
time Help is queued to. They are set to null if not valid. 

Flag set by 'QUEUESUPPORT to indicate when the Support Help Editor has been successfully queued 

to. 

A vector to record the names of panels changed by DeskTop. 
This is the scrolling control variable for the help text displayed in the main window. 
Internal system names of the facility, application, panel and box for which help has been requested. 
Titles of facility, application, panel and box for which Help Text has been requested, as displayed at the 
top of the window. Derived from the help index table in the appropriate data store. 
Keys to the required Help Text and optionally available Tutorial. 
A flag set by the 'BRANCH' procedure to indicate that an attempted branch succeeded. 
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Vector used for holding the required Help Text once it has been retrieved. 
This is the vector which is used to display the requested Help Text In the main window. 
Open panels and windows (including popdowns). 
ON Name: STOP 

5 Function: This block is executed whenever Help is to be quiesced or stopped. If it is queued to from within 
the Help application itself then Help is merely quiesced. otherwise it is stopped. Usually Help is 
only stopped by Control, at the end of a session. 
Calls: None 

The actions performed by this block are as follows:- 
10 If the program is to be quiesced by queueing from elsewhere within it then do that and don't stop it. Also 

stop the Help Map sub-task. 

Otherwise the application is to be stopped (usually only when the whole system is closing down). 
First, save any panels that have been changed via Desktop to the 'User' datastore. 
If either Glossary, Tutorial or Help Map is active then stop them in a controlled manner (going through their 
15 TOP blocks). This is to ensure that any panels which may have been changed are saved. 
Finally, stop the application level task itself. 
Program Name: HELPMAP 

This program consists of a number of blocks of code and procedures, as listed below 
Function: This program is started as a sub-task by the 'Help' program, when a help map is to be 

20 provided. 



Invocation: The starting task first sets up the following 

25 inter- task communication variables (at the 

application level) : 

A, Temp. Facility - Define the subject for 

30 



35 



40 



A. Temp. Application which the help map is to 
A. Temp. Panel be displayed. The values 

A. Temp. Box \XBed tixe same as 

those placed in the 
•S.Help.' variables 
when Help itself is 
called. 



^ Having set up these variables, the starting task 

just starts this program. 



50 



Once this task has been started, the 'A. Temp. ■ 
variables can be set up and this program queued 
to again. This causes this program display a new 
help map, which is appropriate for the newly 
55 specified help subject. 

Panels opened: HelpMap 



16 



EP 0 380 491 B1 



ON Blocks: 



10 



15 



20 



25 



Procedures: 

SETLEVELS 

SETHEADINGS 

SETPARENT 

SETCH ILDFACS 

SETCHILDAPPS 

SETCHILDPANS 

SETCHILDBOXS 

UPDATEDISP 

DOWNSEL 

UPSEL 

PARENTSEL 

CHILDSEL 

Tasks started: 



BREAK 

DESKTOP 

ERROR 

HELP 

QUEUE 

QUIT 

SCROLL 

SELECT 

START 

STOP 

Set subject levels for map. 
Set titles for map levels. 
Set up parent level of map. 
Set up child level, If fac's. 
Set up child level, if app's. 
Set up child level, if pan's. 
Set up child level, if boxes. 
Refresh the whole help map. 
Down arrow select handler. 
Up arrow select handier. 
Parent box select handler. 
Child box select handler. 
General.ShowErr 



30 



35 



40 



45 



50 



55 
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Input: 



I. Messages. Help 



- Translatable strings used 
by the whole Help 
application, for prompts 
etc. 



10 



15 



General . Messages . 
General 



User input 



- Translatable strings for 
general use by all 
programs • 

- From selections etc. 



20 



25 



A. Temp. Facility, 
A. Temp. Application , 
A. Temp. Panel , 
A. Temp. Box 



Define the subject for 
which a help map is to 
be displayed. Set prior 
to running this tasks' 
QUEUE or START blocks. 



30 



35 



40 



45 



50 



55 



♦.Helplndex.* - Help index tables, which 

occur in DataStores which 
contain help text or 
tutorials. Used to build 
the help map. 



Output: A screen display of a help map, which shows in a structured way most of the help text 

available. 

Process: This program is started by the main 'Help* task as a master task. It may also be queued 

to by it. Prior to starting or queueing it the 'A.Temp.** variables are set up to indicate the 
subject around which the help map should be drawn. The user may move round the help 
map and select items of help text to be displayed in the main help text window. When this 
is done this task queues back to the main help task to get the help text displayed. 

Errors: No error should occur during normal running of this program. Any that do are unexpected, 

and are passed to the 'ShowErr* program as normal. 

Dependencies: A help index table must be present in the system DataStore before a map can be created, 
as this forms the root of the map tree. 

Procedure name: SETLEVELS 

Function: This procedure inspects the variables 'FacName', 'AppName', 'PanName' and 'BoxNa- 

me* to determine what the subject of the Help Map should be. It checks that the requested 
Help can be accessed from the top of the Help tree (i.e. it is not isolated). In cases where 
the Help for the required subject is isolated or non-existant the variables are modified to 
make the subject of the Help Map the next most reievent Help at a higher level. As well 
as checking the subject specifying variables, the procedure sets the variables 'ParentLe- 
vel' and 'ChiidLevel', which determine what level of Help is displayed on each of the two 
levels of the map. 

Parameters: No 

Called by. DOWNSEL 
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UPSEL 
ON QUEUE 
Calls: None 

The actions performed by this procedure are as follows:- 
5 Set subject levels for map. 

Check that the System level help is installed, and if it is not terminate the Help Map and issue an error 
message. 

If the facility is 'System* or unspecified then system level help will be used for the subject of the Help Map, 
and the appropriate levels set and checking stopped here. 
w Determine which datastore the Help for the specifed facility will be found. If the datastore does not exist 

backup to the system level. 

If no Help table exists in the datastore which is supposed to contain the Help for the specified facility then 
revert to system level Help and erase the facility name from 'FacName' etc. 
Set up indirect references to the appropriate Help Index table. 
is If no entry for facility Help exists in the appropriate table then revert to system level Help and erase the 

facility name from 'FacName' etc. 

If Help for the specified facility exists but there is no Help at application level, then erase all lower level 
references from 'AppName' etc and revert to system level for the top level of the map. 

If the specified subject does not go below the facility level then stop checking here and set the appropriate 
20 levels. 

If no entry for application Help exists in the appropriate table then revert to facility level Help and erase 
the app'n name from 'AppName' etc. 

If Help for the specified app'n exists but there is no Help at panel level, then erase all lower level references 
from 'PanName' etc and revert to facility level for the top level of the map. 
25 If the specified subject does not go below the app'n level then stop checking here and set the appropriate 

levels. 

If no entry for the panel Help exists in the appropriate table then revert to app'n level Help and erase the 
panel name from 'PanName' etc. 

If Help for the specified panel exists but there is no Help at box level, then erase all lower level references 
30 from 'BoxName' and revert to application level for the top level of the map. 

If the specified subject does not go below the panel level then stop checking here and set the appropriate 
levels. 

If no entry for the box Help exists in the appropriate table then revert to panel level Help and erase the 
box name from 'BoxName*. 
35 Otherwise a valid box level subject has been specified. 

Procedure name: SETHEADINGS 

Function: This procedure sets the appropriate headings above the parent and child boxes on the 

panel, depending on the settings of 'ParentLevel' and 'ChildLevel*. 
Parameters: No 
40 Called by: UPDATEDISP 
Calls: None 

The actions performed by this procedure are as follows:- 
Set titles for map levels. 
Procedure name: SETPARENT 
45 Function: This procedure sets the appropriate title into the parent box depending on the level set 

for it in 'ParentLevel' and the subject of the Help Map as defined by 'FacName' etc. It also 
sets the uparrow if the level of the parent box is below system level. 
Parameters: No 
Called by: UPDATEDISP 
50 Calls: None 

The actions performed by this procedure are as follows:- 
Set up parent level of map. 

Determine which datastore the Help in the parent box is in. 
Set up indirect reference to the titles column in the appropriate help index table. 
55 Set the parent box title. 

Set the up arrow if it is valid. 
Procedure name: SETCHILDFACS 

Function: This procedure sets the titles into the child boxes when the Help to be displayed in them 
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is at facility level. It also determines the names of the real facilities associated with each 
title and sets the down arrows for those facilities which have application level Help. 
Parameters: No 
CaJled by: UPDATEDISP 
5 Calls: None 

The action performed by this procedure are as follows:- 
Set up child level, If fac's. 

Clear the temporary arrays used to hold the data for the child boxes. 
For each datastore active in the system. 
10 Ignore the system datastore. 

Ignore any datastore with no help index table. 

Set up indirect references to columns in the appropriate Help index table. 

Search for the entry for facility level help in the datastore, and if it is not found ignore the datastore. 
Get the title for the facility level help. 
is If title Is unknown or blank ignore this datastore. 

If title is a duplicate ignore this datastore. 

Otherwise this datastore contains valid facility level Help. The Help title and datastore name are loaded 
into the appropriate vectors and the entry in the down arrows vector cleared. 

If the facility has application level help below it, which has a valid title and can thus be displayed on the 
20 Help Map, then set the down arrow for it 

Finally, once the data for the child boxes has been set up in the temporary arrays, sort the temporary arrays 
into the final arrays for the child boxes,.. 
..and initialise the scrolling position. 
Procedure name: SETCHILDAPPS 
25 Function: This procedure sets the titles into the child boxes when the Help to be displayed in them 

is at application level. It also determines the names of the real applications associated 
with each title and sets the down arrows for those applications which have panel level 
Help. 

Parameters: No 
30 Called by: UPDATEDISP 
Calls: None 

The action performed by this procedure are as follows:* 

Set up child level, if app's. 

Determine the datastore that the app'n Help will be found in. 
35 Clear the temporary arrays used to hold the data for the child boxes. 

Set up indirect references to the appropriate Help index table. 
Find no of table entries. 
For each index table entry. 

If the entry is for box or panel or facility level Help ignore it 
40 If title is unknown or blank ignore the entry. 

If title is a duplicate ignore the entry. 

Otherwise just load the app'n ..and initialise the scrolling help info into the appropriate position, temporary 
vectors and clear the down arrows vector entry. 

Then, set the down arrow entry if the app'n has panel level Help below it, which has a valid title and can 
45 thus be displayed on the Help Map. 

Finally, once the data for the child boxes has been set up in the temporary arrays, sort the temporary arrays 
into the final arrays for the child boxes,.. 
..and initialise the scrolling position. 
Procedure name: SETCHILDPANS 
so Function: This procedure sets the titles into the child boxes when the Help to be displayed in them 

is at panel level. It also determines the names of the real panels associated with each 
title and sets the down arrows for those applications which have box level Help. 
Parameters: No 
CaJled by: UPDATEDISP 
55 Calls: None 

The actions performed by this procedure are as follows:- 
Set up child level, if pan's. 

Clear the temporary arrays used to hold the data for the child boxes. 
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Determine the datastore that the panel Help will be found in. 
Set up indirect references to the appropriate Help index table. 
Find no of table entries. 

Find the first entry for the application in the Help index table. 
5 For each index table entry concerning the appropriate application. 

If the entry is for box or application level Help ignore it. 
If title is unknown or blank ignore the entry. 
If title Is a duplicate ignore the entry. 

Otherwise just load the panel Help info into the appropriate temporary vectors and clear the down arrows 
io vector entry. 

Then, set the down arrow entry if the panel has box level Help below it, which has a valid title and can 
thus be displayed on the Help Map. 

Move on to the next entry in the index table if there is one. 

Finally, once the data for the child boxes has been set up in the temporary arrays, sort the temporary arrays 
is into the final arrays for the child boxes,.. 
..and initialise the scrolling position. 
Procedure name: SETCHILDBOXS 

Function: This procedure sets the titles into the child boxes when the Help to be displayed in them 

is at box level. It also determines the names of the real boxes associated with each title 
20 and clears the down arrows. 

Parameters: No 
Called by: UPDATEDISP 
Calls: None 

The actions performed by this procedure are as fbllows:- 
25 Set up child level, if boxes. 

Clear the temporary arrays used to hold the data for the child boxes. 
Determine the datastore that the box Help will be found in. 
Set up indirect references to the appropriate Help index table. 
Find no of table entries. 
30 Find the position of the first box in the index table. 

For each index table entry concerning boxes on the appropriate panel. 
If title is unknown or blank ignore the entry. 
If title is a duplicate ignore the entry. 

Otherwise just load the box Help info into the appropriate temporary vectors and clear the down arrows 
35 vector. 

Move on to the next entry in the index table if there is one. 

Finally, once the data for the child boxes has been set up in the temporary arrays, sort the temporary arrays 
into the final arrays for the child boxes,.. 
..and initialise the scrolling position. 
40 Procedure name: UPDATEDISP 

Function: This procedure updates the Help Map display. 

Parameters: No 
Called by: DOWNS EL 

UPSEL 

45 ON QUEUE 

Calls: SETHEADINGS 
SETPARENT 
SETCHILDFACS 
SETCHILDAPPS 
50 SETCHILDPANS 
SETCHILDBOXS 
The actions performed by this procedure are as follows:- 
Ref resh the whole help map. 
Set the headings above the parent and child boxes. 
55 Set up the parent box and up arrow. 

Set up the child boxes and down arrows (using an appropriate procedure for the level of the child box con- 
tents). 

Procedure name: DOWNSEL 
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Function: This procedure is called whenever a down arrow is selected. It sets the subject defining 

variables to give the appropriate next level of help down and refreshes the Help Map. 
Parameters: No 
Called by: ON SELECT 

5 Calls: SETLEVELS 
UPDATEDISP 

The actions performed by this procedure are as follows:- 
Down arrow select handler. Check that the down arrow Is valid. 

Then, depending on the current child level set the subject defining variables to indicate the next level 
10 down.. 

..and refresh the map. 
Procedure name: UPSEL 

Function: This procedure is called whenever the up arrow is selected. It sets the subject defining 

variables to give the next level of help up and refreshes the Help Map. 
15 Parameters: No 

Called by: ON SELECT 

Calls: SETLEVELS 
UPDATEDISP 

The actions performed by this procedure are as follows:- 
20 Up arrow select handler. 

Check that the up arrow is valid. 

Then, depending on the current parent level set the subject defining variables to indicate the next level 

up.. 

..and refresh the map. 
25 Procedure name: PARENTSEL 

Function: This procedure is called whenever the parent box on the Help Map is selected. It queues 

to the Help master task with a request to display the Help Text for the subject which cor- 
responds to the parent title. 
Parameters: No 
30 Called by: ON SELECT 

Calls: None 

The actions performed by this procedure are as follows:- 
Parent box select handler. 

Depending on the level of the parent box set the appropriate data into the variables which are normally 
35 set before queueing Help,.. 

..and queue to the Help application just like a normal request. 
Procedure name: CHILDSEL 

Function: This procedure is called whenever a child box on the Help Map is selected. It queues to 

the Help master task with a request to display the Help Text for the subject which corre- 
40 sponds to the child title. 

Parameters: No 
Called by: ON SELECT 

Calls: None 

The actions performed by this procedure are as follows:- 
45 Child box select handler. 

Check that the child box has a valid title in it. 

Depending on the level of the child boxes set the appropriate data into the variables which are normally 
set before queueing Help,.. 

..and queue to the Help application just like a normal request. 
so ON Name: BREAK 

Function: This block is executed whenever a BREAK occurs whilst this task is running. This only occurs 
during the ON START block, and causes this task to stop. BREAKS are not allowed anywhere 
else, as there are no slow operations. 
Calls: None 
55 The actions performed by this block are as follows:- 

Flag the Help Map as stopped, and stop. 
ON Name: DESKTOP 

Function: This block is executed whenever a desktop operation is performed in a window which is owned 
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by this task. 
Calls: None 

The actions performed by this block is as follows: - 

If the panel is changed via DeskTop then record the fact so that it can be saved away when the subtask 
5 is stopped. 

ON Name: ERROR 

Function: This block Is called whenever an execution error occurs whilst this program is running. 

The 'ShowErr' program is started to provide some diagnostic information for debugging purpos- 
es, as is standard practice. No errors should occur during normal operation of this program, thus 
10 no attempt is made to trap or handle any. 

Calls: None 

The action performed by this block is as foilows:- 
For debugging purposes. 
ON Name: HELP 

is Function: This block is executed whenever second level help is requested in a window which is owned by 
this task. 
Calls: None 

The action performed by this block is as follows:- 
When help is requested just run the task (ike any other application. 
20 ON Name: QUEUE 

Function: Tasks queue to this block to refresh the Help Map so that it is set up for a particular subject. It 
determines the level of help to be shown on each of the two levels of the map and the specific 
subject around which the map should be based. 
Calls: SETLEVELS 
25 The actions performed by this block are as follows:- 

Determine the intended subject of the help map (these must never become unknown). The 'A.Temp.' va- 
riables are always cleared after usage. 

Determine the levels of help to be displayed at each of the map levels. 
Update the map display with the info for the appropriate levels and subject. 
30 Surface the window. 

ON Name: QUIT 

Function: This block is executed whenever a QUIT operation is performed on one of the windows owned 

by this task. 
Calls: None 
35 The action perform end by this block is as follows:- 

When 'Esc=Cancel' is selected terminate the task. 
ON Name: SCROLL 

Function: This block is executed whenever the help map window is scrolled. 
Calls: None 
40 The actions performed by this block are as follows:- 

Determine how many child titles there are. 

Find out how many can be displayed in the window. 

Scroll the appropriate amount in the requested direction. 

Limit the scrolling to ensure that the ends of the data are not exceeded and hide and show the boxes which 
45 indicate if there is more data in either direction. 
ON Name: SELECT 

Function: This block is executed whenever a SELECT takes place in one of the windows which is owned 

by this task. 
Calls: UPSEL 
50 DOWNSEL 

RARENTSEL 

CHILDSEL 

The action performed by this block is as follows:- 

Depending on where the select takes place on the Help Map, call an appropriate procedure to deal with 

55 it. 

ON Name: START 

Function: This block is executed when the Help Map part of the help application is started. This is usually 
when the 'Help Map' button on the main help text 'Reference' pull-down has been selected. 
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Calls: None 

The actions performed by this block are as follows:- 
Enable BREAKs. 

This is the scrolling control variable for the child boxes on the help map. 
5 Flag to record if the panel has been changed via 'DeskTop'. 

Internal system names of the facility, application, panel and box for which a Help Map has been requested. 
Level of help for each of the two levels of the help map. ( May be 'System', 'Facility', •Application\ 'Panel', 
or 'Box'.) 

The titles of the help at the higher and lower levels of the Help Map, as displayed in the appropriate boxes. 
10 The real names of the entities whose titles are displayed in the child boxes. 

The arrows that indicate if the user can move up or down the map from a given item. 
Open panel and window. 

Queue to the 'ON QUEUE' block to refresh the display. 
ON Name: STOP 

is Function: This block is executed whenever the program Is to be stopped. This is usually by queueing from 
elsewhere within it, e.g. from the code which handles the 'Esc=Quif button. 
Calls: None 

The actions performed by this block are as follows:- 
When stopping.. 
20 ..save the panel if it has been changed via DeskTop,.. 
..flag the Help Map as stopped... 
..and stop. 



25 Claims 

1. A data processing system having a work station including 

a display (15) for displaying on a screen panels of information relating to one or more tasks, the 
panels being viewable through windows under the control of a display manager, and 
30 operator input means by which an operator can communicate with said system interactively, said 

operator input means including 

indicator means (19) for identifying items on said screen by means of a visible on-screen indicator 

(32). 

selection means (20) for communicating a selection to said system on the basis of displayed infor- 
35 mation and 

help request means (21) for requesting help information from said system; said system further in- 
cluding 

an addressable store (92) in which hierarchically related units of help text information are stored, 
contextual help means responsive to an appropriate request for help from said help request means 
40 and responsive to the current state of the system when help was requested to access said addressable 

help text store to obtain appropriate help text and to cause the display manager to display said help text 

through a help text window (24) on said screen, concurrently with the information related to the task or 

tasks in hand which was being displayed when help was requested, 

help map display means responsive to selection by said selection means to cause said display man- 
45 ager to display in a separate window (26), concurrently with said help text window, at least a portion of a 

hierarchical map of the stored help text, each entry (29) of which corresponds to a unit of stored help text, 

and 

means responsive to selection of a map entry by said selection means to cause help text corre- 
sponding to the selected map entry to replace that in the help text window. 
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2. A system as claimed in claim 1 wherein the selection means is associated with the indicator means so 
that the displayed item indicated by the visible indicator is selectable by operation of the selection means. 

3. A system as claimed in claim 1 or claim 2 in which the current state of the system is defined by a plurality 
of system state variables which the contextual help means applies as addressing information to obtain a 
corresponding unit of help text in the help text store. 

4. A system as claimed in claim 3 in which the system variables are ranked in order, the help text store hi- 
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erarchy having corresponding orders of help text so that system states whose definition includes low order 
system variables are associated with low order help text and system states whose definition includes only 
high order variable are associated with higher order help text 

5. A system as claimed in claim 3 or claim 4 in which the system variables are applied as addressing Infor- 
mation to a key table to produce a key which is the actual address of a unit of help text in the help text 
store. 

6. A system as claimed in any one of claims 3 to 5 in which the low order system variables relate to the pos- 
ition of the indicator on the screen. 

7. A system as claimed in claim 6 in which one system variable corresponds to the panel in which the indicator 
is located, a tower order system variable corresponds to the location of the indicator within a predefined 
box in the panel and a higher order system variable corresponds to the application which owns the panel, 
there being three corresponding orders of help text for boxes, panels and applications, the panel order of 
help being selectable from a predefined help box in the panel or from a non-boxed area of the panel and 
the application order of help being selectable from the help map or from a system state in which the lower 
order system variables are set to null values. 

8. A system as claimed in claim 7 in which the help text store also contains help text for a facility order of 
20 help, above the application order of help, and corresponding to a facility order system variable. 

9. A system as claimed in any preceding claim including means for generating the help map dynamically 
from the help text store in response to selection of said help map display means. 

25 10. A system as claimed In any one of claims 3 to 8 or in claim 9 as dependent on claim 3 in which the help 
may is too large to be viewed through a help map window, the help map display means being responsive 
to the current system variables, where these do not define the highest order system state, to select for 
display map entries of the same order as the current system variables which share common higher order 
system variables and also to select for display the higher order entry represented by said common higher 

30 order variables 

11. A System as claimed in claim 10 in which the help map display means includes a selectively operable 
branching means, selection of branching for a given map entry causing display of a new help map including 
the given entry as the higher order entry, where the given entry was originally one of the lower order en- 

35 tries in the map, and as one of a group of lower order entries, where the given entry was originally the 

higher order entry in the map. 

12. A system as claimed in claim 11 as dependent on claim 2 in which the displayed map entries include icons 
indicating the permitted direction of branching, if any, the branching operation being selected by operation 

40 of said selection means when said visible indicator is positioned on one of said icons. 

13. A system as claimed in claim 2 in which a unit of help text can include selectable branch words within the 
body of the text which are associated with related units of help text, the system including help text branch- 
ing means responsive to selection of a selectable word in a help text window by the indicator means and 
the selection means to access the related unit of help text in the help text store and to cause the display 
manager to replace the original help text in the help text window with said related unit of help text 
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14. A system as claimed in claim 13 in which the system includes a glossary store, selection of a help text 
word other then a selectable branch word causing display of a glossary window containing a definition of 
the selected word or a list of the alphabetically nearest words. 

50 

15. A method of providing help to a user of a data processing system having a work station including a display 
and 

operator input means by which an operator can communicate with the system interactively, said 
operator input means including 
55 indicator means (1 9) for identifying items on said screen by means of a visible on-screen indicator 

(32). 

selection means (20) for communicating a selection to said system on the basis of displayed infor- 
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mation and 

help request means (21) for requesting help information from said system; 

said system further including an addressable store (92) in which help text information units are 
mapped in hierarchical order; the method comprising the steps of accessing said addressable help text 
5 store in response to a request for help from said help request means and in response to the current state 

of the system to obtain appropriate help text, 

displaying said help text concurrently with the information related to the task or tasks in hand, 

responding to selection of help map function by the user to display, separately from the help text 
but concurrently therewith, at least a portion of a hierachical map of the stored help text each entry of 
10 which corresponds to a unit of stored help text and 

responding to a further selection by the user of an entry on the help map to display new help text 
replacing that originally displayed. 



is PatentansprOche 

1 . Eine Datenverarbeitungsanlage mit einer Workstation, folgendes umfassend: 

eine Anzeige (15) zum Anzeigen von Informations -Panels, die sich auf eine Oder mehrere Tasks beziehen, 
auf einem Bildschirm, wobei die Panels durch Fenster unter Steuerung durch einen Bildschirm-Ver waiter 
20 sich t bar sind, und 

Bediener-Eingabemittel, uber die ein Bediener mit der genannten Anlage interaktiv kommunizieren kann, 
wobei die genannten Bediener-Eingabemittel folgendes aufweisen: 

Anzeigemittel (19), zur Kennzeichnung von Elementen auf dem genannten Bildschirm mit Hilfe eines 
sichtbaren Anzeigers (32) auf dem Bildschirm, 
25 AuswShlmittel (20), die dazu dienen, dem genannten System auf der Basis der angezeigten Information 

eine Auswahl mitzuteilen und 

Hilfe-Anforderungsmittel (21), mit denen Hilfe-lnformationen von dem genannten System angefordert 
werden kdnnen; das genannte System umfaBt desweiteren 

einen adressierfShigen Speicher (92), in dem hlerarchisch verbundene Einheiten von Hilfetext-lnforma- 

30 tionen gespeichert sind, 

kontextuale Hilfemittel, die auf eine entsprechende Hilfe-Anforderung von dem genannten Hilfe-Anfor- 
derungsmittel reagieren, sowie auf den aktuellen Systemstatus zu dem Zeitpunkt, an dem Hilfe angefor- 
dert wurde, urn auf den genannten adressierfShigen Hilfetextspeicher zuzugreifen, zurGewinnung eines 
entsprechenden Hilfetextes und urn zu bewirken, da& der Bildschirm-Ver waiter den genannten Hitfetext 

35 in einem Hilfetext-Fenster (24) auf dem genannten Bildschirm anzeigt, gleichzeitig mit der Information, 

die sich auf die gerade anstehende(n) Task(s) bezieht, die bei der Anforderung von Hilfe angezeigt wur- 
de(n), 

Hilfe-Map-Anzeigemittel, die auf eine Auswahl mittels des genannten AuswShlmittels reagieren, und be- 
wirken, daft der genannte Bildschirm-Verwalter in einem separaten Fenster (26) gleichzeitig mit dem ge- 
40 nannten Hilfetext-Fenster mindestens einen Tell einer hierarchischen Map des gespeicherten Hilfetextes 

anzeigt, wobei jeder Eintrag (29) hierin einer Einhelt des gespeicherten Hilfetextes entspricht, und 
Mittel, die auf die Auswahl eines Map-Eintrags durch das genannte AuswShlmittel reagieren und bewir- 
ken, da& Hilfetext, der dem ausgewShlten Map-Eintrag entspricht, den im Hilfetext-Fenster angezeigten 
Hilfetext ersetzt 

45 

2. Ein System nach Anspruch 1 , bei dem das AuswShlmittel dem Anzeigemittel zugeordnet ist, so dak das 
von dem sichtbaren Anzeiger angezeigte Element durch BetStigung des AuswShlmittels auswahlbar ist. 

3. Ein System nach Anspruch 1 oder Anspruch 2, in dem der aktuelle Status des Systems durch eine Vielzahl 
so von System-Status- Variablen def iniert ist, welche von dem kontextualen Hilfemittel als Adressierinforma- 

tion verwendet werden, um eine entsprechende Hilfetext-Einheit in dem Hilfetext-Speicher zu erhalten. 

4. Ein System nach Anspruch 3, in dem die System- Variablen in einer bestimmten Ordnung angeordnet sind, 
wobei die Hierarchie im Hilfetextspeicher eine entsprechende Ordnung des Hilfetextes aufweist, so da& 
SystemzustSnde, deren Definition Systemvariablen derunteren Ordnung enthalten, dem Hilfetext der un- 

5o teren Ordnung zugeordnet werden, und SystemzustSnde, deren Definition nur Variablen der hdheren Ord- 

nung enthalten, dem Hilfetext der hfiheren Ordnung zugeordnet werden. 
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5. Ein System nach Anspruch 3 Oder Anspruch 4, in dem die Systemvariablen als Adressierinformation zu 
einer SchlGsseltabelle angewendet werden, um einen Schlussel zu erzeugen, welcher die aktuelle Adres- 
se einer Hilfetext-Einheit im Hi Ife texts peicher ist 

6. Ein System nach jedem der Anspruche 3 bis 5, in dem die Systemvariablen der unteren Ordnung auf die 
Position des Anzeigers auf dem Bildschirm bezogen sind. 

7. Ein System nach Anspruch 6, in dem eine Systemvariable dem Panel entspricht, in dem der Anzeiger sich 
befindet, eine Systemvariable der unteren Ordnung der Position des Anzeigers innerhalb eines vordef i- 
nierten Felds in dem Panel entspricht, und eine Systemvariable der hdheren Ordnung der Anwendung 
entspricht zu der das Panel gehdrt, wobei drei entsprechende Ordnungen von Hilfetext fur Felder, Panels 
und Anwendungen vorhanden sind, die Panel-Ordnung der Hilfe von einem vordef inierten Hilfe-Feld in 
dem Panel oder von einem PanelBereich ohne Feld auswdhlbar ist, und die Anwendungs-Ordnung der 
Hilfe von der Hilfe-Map Oder von einem Systemstatus auswflhlbar ist, in dem die Systemvariablen der 

15 unteren Ordnung auf Nullwerte gesetzt sind. 

8. Ein System nach Anspruch 7, in dem der Hilfetextspeicher auch Hilfetext fQr eine Einrichtungs- 
Hilfeordnung enthalt die uber der Anwen dungs- Hi ifeordnung liegt, und einer Systemvariablen der 
Einrichtungs-Ordnung entspricht 

20 9. Ein System nach jedem der vorangehenden Anspruche, Mitte! enthaltend zur dynamischen Erzeugung 
der Hilfe-Map aus dem Hilfetextspeicher in Antwort auf die Auswahl des Anzeigemittels der genannten 
Hilfe-Map. 

10. Ein System nach jedem der Anspruche 3 bis 8 oder nach Anspruch 9 in Abhangigkeit von Anspruch 3, in 
25 dem die Hilfe-Map zu groB ist, um durch ein Hiife-Map-Fenster betrachtet werden zu kdnnen, wobei das 

Hilfe-Map-Anzeigemittel auf die aktuellen Systemvariablen reagiert wo dtese nicht den Systemstatus 
hdchster Ordnung definieren, um die Anzeige von Map-Eintragen derselben Ordnung wie die aktuellen 
Systemvariablen auszuwdhlen, die gemeinsame Systemvariablen hdherer Ordnung verwenden, sowie 
auch zur Auswahl der Anzeige des Eintrags hdherer Ordnung, der von den genannten gemeinsamen Va- 
30 riablen hdherer Ordnung dargestellt wird. 

11. Ein System nach Anspruch 10, in dem das Hilfe-Map-Anzeigemittel ein selektiv ablauffShiges Verzwei- 
gungsmittel umfa&t wobei die Auswahl der Verzweigung fur einen gegebenen Map-Eintrag die Anzeige 
einer neuen Hilfe-Map bewirkt, die den gegebenen Eintrag als den Eintrag hdherer Ordnung enthalt, wo 

35 der gegebene Eintrag ursprunglich einer der Eintrfige der unteren Ordnung in der Map war, und a)s ein 

Eintrag einer Gruppe von Eintrfigen der unteren Ordnung, wo der gegebene Eintrag ursprunglich der Ein- 
trag hdherer Ordnung in der Map war. 

1 2. Ein System nach Anspruch 1 1 in Abh§ ngigkeit von Anspruch 2, in dem die angezeigten Map-EintrSge Bild- 
40 symbole enthalten, die gegebenenfatls die zutdssige Verzweigungsrichtung anzeigen, wobei die Verzwei- 

gungsoperation durch Betfltigen des genannten Auswdhlmittels ausgewfihlt wird, wenn der genannte 
sichtbare Anzeiger auf einem der genannten Bitdsymbole position iert wird. 

13. Ein System nach Anspruch 2, in dem eine Hilfetext-Einheit innerhalb des Textkdrpers auswfihlbare Ver- 
^ zweigungsworte enthalten kann, die den verbundenen Hilfetext-Einheiten zugeordnet sind, wobei das Sy- 
stem Hilfetext-Verzweigungsmittel umfa&t die auf die Auswahl eines auswdhlbaren Wortes in einem Hil- 
fetext- Fen ster durch das Anzeigermittel und das AuswShlmittel reagieren, um auf die verbundene Hilfe- 
text-Einheit in dem Hilfetext-Speicher zuzugreifen und zu bewirken, daft der Blldschirm-Verwalter den 
ursprunglichen Hilfetext in dem Hilfetext- Fens ter gegen die genannte verbundene Hilfetext-Einheit aus- 
tauscht. 
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14. Ein System nach Anspruch 1 3, bei dem das System einen Gfossar-Speicher umfa&t, wobei die Auswahl 
eines Hi Ife text- Wortes, das kein auswdhlbares Verzweigungswort ist, bewirkt, dad ein Glossar-Fenster 
angezeigt wird, welches eine Definition des ausgewdhtten Wortes oder eine Liste des alphabetisch ndch- 
sten Wortes en thai t 

15. Eine Methode, um einem Benutzer einer Datenverarbeitungsanlage mit Workstation, eine Anzeige um- 
fassend, Hilfe bereitzustellen und 
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Bediener-Eingabemittel, mit denen ein Bediener mit dem System Interakttv kommunizieren kann, wobei 
die genannten Bediener-Eingabemittel folgendes umfassen: 

Anzeigemittei (19) zurKennzeichnung von Etementenauf dem genannten Bildschirm mit Hilfe etnes sicht- 
baren Anzeigers (32) auf dem Bildschirm 
5 Auswahlmittel (20), urn dem genannten System auf der Basis der angezeigten Information eine Auswahl 

mitzuteilen und 

Hilfe-Anforderungsmittel (21), zur Anforderung von Hilfe info rmationen von dem genannten System; 
das genannte System umfa&t desweiteren einen adressierfflhigen Speicher (92), in dem Hilfetext-lnfor- 
mationseinheiten in hierarchischer Ordnung abgebildet sind; die Methode umfa&t folgende Schrltte: Zu- 
10 griff auf den genannten adressierffihigen Hilfetext-Speicher in Ant wort auf eine Hilfeanfrage von dem ge- 

nannten Hilfe-Anforderungsmittel und in Ant wort auf den aktuellen Systemstatus, um einen entsprechen- 
den Hitfetextzu bekommen, 

Anzeigen des genannten Hilfetextes gleichzeitig mit der Information, die zu der/den anstehenden Task(s) 
gehdrt, 

is Reagieren auf die Auswahl der Hilfe-Map-Funktion durch den Benutzer, um, getrennt von dem Hilfetext, 

jedoch gleichzeitig mit diesem, mindestens einen Tell einer hierarchlschen Map des gespeicherten Hilfe- 
textes anzuzeigen, wobei jeder Eintrag in dieser einer Einheit des gespeicherten Hilfetextes entspricht 
und 

Reagieren auf eine weitere Auswahl eines Eintrags in der Hi Ife-Map durch den Benutzer, um einen neuen 
20 Hilfetext anzuzeigen, der den ursprunglich angezeigten ersetzt 



Revendications 

25 1. Systeme de traitement de donnees ayant une station de travail comprenant : 

un affichage (15) pour afficher sur un ecran des panneaux d'information concernant une ou plu- 
sieurs taches, les panneaux etant aff ichables dans des fandtres sous le controle d'un g est ion na ire d' af- 
fichage, et 

des moyens d'entree d'operateur grace auxquels un operateur peut communiquer de fa con inte- 
30 ractive avec ledit systeme, lesdits moyens d'entree d'operateur comprenant 

un moyen indicateur (19) pour identifier des items sur ledit ecran au moyen d'un indicateur visible 
sur r ecran (32) 

un moyen de selection (20) pour communiquer une selection audit systeme sur la base d'une in- 
formation aff ichee, et 

35 un moyen de demande d'aide (21) pour demander des informations d'aide audit systeme ; ledit sys- 

teme comprenant en outre : 

une memoire adressable (92) dans laquelle des unites d'informations d'aide en relation hierarchi- 
que sont emmagasinees, 

un moyen d'aide contextuel sensible a une demande appropriee d'aide provenant dudit moyen de 
40 demande d'aide et sensible a I'etat courant du systeme quand I 'aid e a ete demandee pour acceder a ladite 

memoire de texte d'aide adressable et obtenlr un texte d'aide appro pile et fa ire afficher par ledit gestion- 
naire d'aff ichage ledit texte d'aide dans une fenetre de texte d'aide (24) sur ledit ecran, concurremment 
avec les informations relatives aux taches en cours qui etaient aff ichees lorsque I'aide a ete demandee, 
un moyen d'aff ichage de mappe d'aide sensible a la selection par ledit moyen de selection pour 
45 faire afficher par ledit gestionnaire d'aff ichage dans une fenetre separee, concurremment avec ladite fe- 

netre de texte d'aide, au moins une portion d'une mappe hierarchique du texte d'aide emmagasine, dont 
chaque entree (29) correspond a une unite de texte d'aide emmagasine, et 

un moyen sensible a la selection d'une entree de la mappe par ledit moyen de selection provoquant 
le remplacement du texte d'aide de la fenetre de texte d'aide par le texte d'aide correspondant a I'entree 
so de mappe selectionnee. 

2. Systeme tel que revendique dans la revendication 1, dans tequel le moyen de selection est associe au 
moyen indicateur de sorte que I'item af f iche indique par I'indicateur visible puisse etre selectionne par le 
fonctionnement du moyen de selection. 

55 

3. Systeme tel que revendique dans la revendication 1 ou 2, dans lequel I'etat courant du systeme est def ini 
par une plural ite de variables d'etat de systeme que le moyen d'aide contextuel applique comme infor- 
mations d'adressage pour obtenir une unite correspondante de texte d'aide dans la memoire de texte 
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d'alde. 

4. Systems tel que revendique dans la revendication 3, dans lequel les variables du systeme sont rangees 
en ordre, la hierarchie de la memoire de texte d'aide ayant des ordres correspondants de texte d'alde de 
5 sorte que les etats de systeme dont la definition inclut des variables de systeme d'ordre inferieur sont 

associes a du texte d'aide d'ordre inferieur et les etats de systeme dont la definition Inclut seulement des 
variables d'ordre sont associees a du texte d'aide d'ordre plus eleve. 



10 



5. Systeme tel que revendique dans la revendication 3 ou 4, dans lequel les variables de systeme sont ap- 
pliquees comme informations d'adressage a une table de Ms pourfournir une cle qui est I'adresse reelle 
d'une unite de texte d'aide dans la memoire de texte d'aide. 

6. Systeme tel que revendique dans une des revendications 3 a 5, dans lequel les variables de systeme d'or- 
dre inferieur concernent la position de i'indicateur sur I'ecran. 

15 7. Systeme tel que revendique dans la revendication 6, dans lequel une variable de systeme correspond au 
panneau dans lequel I'indicateur est place, une variable de systeme d'ordre inferieur correspond a ('em- 
placement de I'indicateur dans un bloc predef ini du panneau et une variable de systeme d'ordre superieur 
correspond a ('application qui occupe le panneau, trols niveaux correspondants de texte d'alde existant 
pour les blocs, les panneaux et les applications, I'ordre du panneau d'aide pouvant etre selectionne a par- 

20 tir d'un bloc d'aide predef ini du panneau ou a partir d'une zone du panneau en dehors du bloc et I'ordre 

d'application d'aide pouvant etre selectionne a partir de la mappe d'aide ou a partir d'un etat de systeme 
dans lequel les variables de systeme d'ordre inferieur sont mises a zero. 

8. Systeme tel que revendique dans la revendication 7, dans lequel la memoire de texte d'aide contient aussi 
25 du texte d'aide pour un ordre de dispositif d'aide, au-dessus de I'ordre d'application, et correspondent a 

une variable de systeme d'ordre de dispositif. 

9. Systeme tel que revendique dans une des revendications precedentes, comprenant un moyen pour ge- 
nerer la mappe d'aide dynamiquement a partir de la memoire de texte d'aide en reponse a la selection 

30 dud it moyen d'aff ichage de mappe d'aide. 

10. Systeme tel que revendique dans une quelconque des revendications 3 a 8 ou 9 dependant de 3, dans 
lequel I'aide est trap importante pour etre aff ichee dans une fenetre de mappe d'aide, le moyen d'aff i- 
chage de mappe d'aide etant sensible aux variables de systeme courantes, ou celles-ci ne def inissent 

35 pas I'etat de systeme d'ordre le plus eleve, de facon a selectionner des entrees de mappe d'aide du meme 

ordre que les variables de systeme courantes qui partagent des variables de systeme communes d'ordre 
plus eleve et aussi pour selectionner pour aff ichage I'entree d'ordre plus eleve represents par lesdites 
variables communes d'ordre plus eleve. 

40 11. Systeme tel que revendique dans la revendication 1 0, dans lequel le moyen d'aff ichage de mappe d'aide 
comprend un moyen de branchement mis en oeuvre de facon selective, (a selection du branchement pour 
une entree de mappe donnee provoquant raff ichage d'une nouvelle mappe d'aide comprenant I'entree 
don nee comme entree d'ordre le plus eleve, ou I'entree donnee eta it a I'origine une des entrees d'ordre 
inferieur de la mappe et comme I'une d'un groupe d'entrees d'ordre inferieur ou I'entree donnee etait a 
I'origine I'entree d'ordre le plus eleve de la mappe. 



45 
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12. Systeme tel que revendique dans la revendication 11 dependant de la revendication 2, dans lequel les 
entrees de mappe aff ichees comprennent des icones indiquant la direction permise de branchement si 
necessaire, I'operation de branchement etant selectionnee par ledit moyen de selection lorsque ledit in- 
dicates visible est positionne sur Fun desdits icdnes. 



13. Systeme tel que revendique dans la revendication 2, dans lequel une unite de texte d'aide peut indure 
des mots de branchement pouvant etre selectionnes dans le corps du texte qui sont associes a des unites 
du texte d'aide, le systeme comprenant un moyen de branchement de texte d'aide sensible a la selection 
d'un mot pouvant etre selectionne dans une fenetre de texte d'aide par le moyen indicateur et le moyen 
55 de selection pour acceder a I'unite du texte d'aide dans la memoire de texte d'aide et pour provoquer le 

remplacement par le gestionnaire d'aff ichage du texte d'aide d'origine dans la fenetre de texte d'aide par 
ladite unite de texte d'aide. 
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Systeme tei que revendique dans la revendication 13, dans tequel le systems comprend una memoirs 
glossaire, la selection d'un mot de texts d'aide autre qu'un mot de branchement pouvant etre selectionne 
provoquant faff ichage d'une fenetre glossaire contenant une definition du mot selectionne ou une liste 
des mots alpha betiquement les plus proches. 

Methods pour fournir de I'aide a un utilisateur d'un systems de traitement de donnees ayant une station 
de travail comportant un aff ichage et 

un moyen d'entree d'operateur au moyen duquel un operateur peut communiquer avec le systems 
de facon interactive, ledit moyen d'entree d'operateur comprenant: 

un moyen indlcateur (19) pour identifier des items sut ledit ecran au moyen d'un indlcateur (32) 
visible sur ecran, 

un moyen de selection (20) pour communiquer une selection audit systeme sur la base des infor- 
mations aff ichees, et 

un moyen de demande d'aide (21) pour demander des informations d'aide au systeme, 

ledit systeme comprenant en outre une memoirs adressable (92) dans laqueife des unites de texte 

d'aide sont map pees en ordre hierarchique, la methods comprenant les etapes: 

d'acceder a ladite memoirs de texte d'aide adressable en reponse a une requete d'aide a partir 

dudit moyen de demande d'aide et en reponse a I'etat courant du systeme pour obtenir du texte d'aide 

approprie, 

d'aff icher ledit texte d'aide concurremment avec les informations relatives aux taches en cours, 
de repondre a la selection d'une fonction de mappe d'aide par I'utilisateur pour afficher separement 
du texte d'aide et concurremment, au mo ins une portion d'une mappe hierarchique du texte d'aide en me- 
moirs dont chaque entree correspond a une unite de texte d'aide en memoirs, et 

de repondre a une autre selection par I'utilisateur d'une entree de la mappe d'aide pour afficher 
du nouveau texte d'aide remplacant celui aff iche a I'origine. 
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